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Errata 



Revised Disk Loading Instructions 

The diskette supplied after 17/03/82 is no lonjar self-tooting. The 
auto a*rannd will load the file SIHJ/O© on fxwer-up. 

At COS RfiUJY pWy t type BASIC press <EJTH*> 

To HM »m FILES question press OTT3t> 

TO MEM SIZS question type 

600O0 <&TOO (48k norory) or 43616 <EWTER> (32* iw*ory) 

At READY prccpt type RUW^nOSIN" press <RJTEK> 

Execution will then to under prognrao control. Follow the 
instructions in 'Getting started* (Disk demonstrations) on Page 4. 

Routine lo Load Character Sets saved using Ihc Setup Programme 

10 UN 10 BE USED WITH SYSTEMS AFHR 17/03/82 

20 G£A«5000:17MEM<2000CmiQO>^Q-SB3S-4:J4000 

30 CLSiIWWQtTER G*A*>HICS WWB ";<#$ 

40 IFRI<wrS(G0S r 4)O"/PlC-IWC*LX^XXJS+*/PtC" 

50 0>Sl»;9000:a^iOUri55 l liK«X«128r0255 

60 reiHTX;CHRS(X)j*lBtt 

70 PRIHT:PRWT: INK/TRUSS WTER TO RE-RUN ";A 

80 OTTO30 

19000 frliCG6U&20(Mi?Qtt<nO6x<miA+UN$=tt 

19005 V=VWP1R(ABS»:PDKE16425,1iPC«E16424,X:Y9-USR9(V) 

190)0 Nrar:QCKSE:O£TJ£Rl^&IIB8lDH>SEXMJSRl(0):KJnURN 

200O0 ASS^mrN3S(252 l 32);XFUSft9^J^2e+OSiOPEN"R ,, ,l,CQS 

20010 IFIOP(l)=0ANrW=llHEICLOSE:KnLCOS:ESrcR 55:031020030 

2O020 FlH J m,252ASftCS 

20030 RBIWN 
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Introduction 



Introduction 

THS-&0 Mriel 1 graphics are AX based and limited to the 3 down by 2 
across block patterns represented by character codes 128 to 191 
inclusive (Hex BO-BP) 

High resolution RAM based graphics **jpple<rent the existing graphics en 
the TRS-80 by allowing the user to create as ffany sots of up to 12& 
high resolution graphic characters as the inagination will allow. Each 
set cay be saved to disk or tape for recall as desired. 

the screen of the TRS-80 is divided into 1024 print locations, 64 
horizontally en each of 16 vertical lines, each off these 1024 positions 
can display one character, (graphic o: otherwise). As stated, a graphic 
character consists of a examination of the 3 down by 2 across blozfc 
pattern which toxcs up the display area 

I.e. Printing CHR$(L29) would display tte top left haixl block of the 
6 blocks available at the pri/it location. 
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examination of this display uould ahow that the illuminated portion 
consists of 4 horizontal scanning linee (rows) with 3 dots p*r rev; ac 
the total character display area consists of 6 of these blocks it 
i>ftceesarily follcws that there are a total of 12 ra-ra each with 6 dsts, 
i.e. a 12x6 dot matrix. Control of each of these dots iirproves the 
resolution of the display by a 12 to 1 ratio. 

High resolution RAH baaed graphics achieves this and even sore, 
in addition to providing such high resolution graphics over the 
character code range 123 to 191 the facility is extended to overlay the 
compression cede area of 192 to 255 (He Of?) giving 128 characters 
in each set created. 

Whilst the full eet of Tandy graphics are retained arc* available on 
power up or by nuking a sinple "COT 150,1" statement, they canrot fce 
displayed on the screen at the sane tine as the high resolution 
graphics. However as 12H high resolution graphics characters are 
available it is possible for the user to reproduce the Tardy set 
together with 64 other chararters. 



Introduction (continued) 



Whe:i the lowttr jaao dtiver suppHed is loaddd all 128 hig! resolution 
characters (Cedes 128 to 255 {;jm 80-FT*)J can be TOGO, PRINTS? SZffiL* 
or RUNTS) in STRUGS onto tnc scrwn uaing ordinary BASIC statenunts 
or ASShMRLf ocdo. 

Mjre ;- Hwij lower case has been loaded/ tranatec batwoun upper **J 
lower ms* is possible by 9nruUaneou»ly pttfMiny the <WIrT> and 

<sp*>: aw> or <&nn> and <o>. 



General Description 

Tnv -ludi'ication rvcoss&ry to achi*>vc* tN*so high resolution graphics 

involvesi* 

The provision of additional RAM i*upplied in a neperate expansion 

box). 

The Cutting of in actional rifcton caole to the keyboard and the 

infiMi lotion or 4 Cully dMCWding lower case nJlCioaLiOO* IS a 
ditrer^tt lower ca« aol. has bo« fitted it will be replace!, 

TV ndniauro machine r2*ju:re*nent for this unification is 1— 

4K :ewl if. (UK level II up i« rocammdod) 

None of the 4 to 4SK of RAM in the Ctnpjwr configuration i* require* 
to provide the high resolution graphic* facility, as all of th* ram 
required is contained in the expansion 6>x atipplied. 



Asfortoly of the modified units is quite sitrpie. 

fl) tafeoble the Ccf^uter in the normal configuration. 

(2) Plug the new ribbon cabl* (Oh tht fc*yboar£ Into the RAM 
expansion box supplied. 

H) Pot a Keylxiird only system, plug the wider ribton cable iroa the 
RAH t9cn*/v*ioft box into the Keyboard ftcpansion Port. 

For an F^cpansion Interface system, plug the wider ribbon cable 
from the RAH expansion box into the interlace Expansion Ftart. 

14) Power up as normal . 

Plcaae rarer to Appropriate picture on page 14. 

Mi nccoasary driver progr&roes vo applied on a self booting diskette 
or a seU running cassotto. As far as it la feasible to say all 
existing software will continue to perform in tho s-vrc ranncr as toCore 
with this nzxiUicalion instilled. 
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Introduction (continued) 



How It Works 

Tte» 128 graphic characters available at** oily accessible h, himhs u r 
"OUI" slat emits. This is due to th? fact that thjy overlay tr> fun.* 
nwmry location as !CT. ttorraily RCM cannot be written t#* ir *.;>: TRS-60 
ait by osir>| 4 of tfw* 256 avail abU* pxirts, tb? high r*M)lt!tWl graphics 
RAM cc»n *>■ AccrtAod *nd written to. 



The "OLT" statra-nts uso3 with the hiqh resolution graphic* or*-:* 

CUT !3u , 1 » Display high resolution graphics. 

WT 140 , 1 m /Jlow writing to RAM graphics, 

OCT 150 t I * Display Tardy graphics (default <v\ pewr up and 
reset). 

OTT 15S , I * Hoom high resolution RAM qrapiiiw. 



The character codes which nny be used to display high mwluttofl 
graphics are 128 to 255 Inclusive. 

The flrrory locations us*^ by the high resolution graphics RAM ar* fro© 
to 2047 decimal . As cniy 12 lines of data are used tn form a graphic 
character, it is noccessary to skip 4 ncrory locations between tho 
prcgraminq of each character. This rams that ncrory lecatiens 0-li 
will hold the first character, 16-32 tho socwi character ani 32-43 the 
third character etc.. 

Bach nxy location hjlds crwj graphic line. Therefore to programs a 
single line across a character the decimal nontoer representing the 
first 6 binary digits nust be PCKEO into tho nsairy location. The 
decimal runfcer will be between wd 63. PCKE-irq will leave a blank 
lint* whereas POfOi-ing 63 will white out that line. An oc*q>l* of this 
techniqu- i* demonstrated in a programme on pige L3, 
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At this juncture disfc users can skip the following section <*v3 cuntinue 
reading overleaf at the section headed "<ETTirc STARTH3 |- Disk 
Demonstration." 



' [ 


::: -■■ r 




•.. T 


ft 




AM 

1 ■ f 

~4- 


■> 


T 


:l 


i7 


•J 


*l 


■J 


y» 


1 1 


vi 




*o 



„ 3 



IN. WU. r ^t^ t '^l-'»P*«> 



Setup 



Getting Started (Cassette Rased Graphics) 

1. Power up corputer and Answer "rtrory Size" by pressing <8NRR>* 

2. Put "GRAPH 1 ' side of tape into recorder ard ensure it is rewound. 

3. To "FEACY" ^roipt type SfOTEM and press OJTER>. 

4. To ■*?■ prccpt type GRAPH, pit rorarder into PIAY, press <QJTER>. 

5. Following a successful load, a "SEaDY* prenpt will appear, 

6. Turn tape ever to "SEIW" side and rewind. 

7. Press Pivtf, type CLOAD and press <&?TER>, 

8. Ctt oarpletion of load type HJW ard press <ENTEft>. 

Ycu are now in the setup node and can beqlr. to experiment ard create 
your on high resolution graphic characters. Ycu are now advised to 
read the section toadai "USIffi TOE SY3TW on pe^e 5 relating to the 
ufie of cption 3. All ccmtvirrifl explained are useable with tha exception 
of those indicated by (Disk Cttly) and the <S>ave COTrairt, 
To save jour character set, use a new or erased tape ana type <S>. Th* 
screen will clear and full instructions win be displayed at the top, 
Tne programs written to tape will have the system naro "GRAPH*. 
Stould you wish to lo*3 a previously saved character set, gress <£>nd 
and answer Y to exit question ard then follow load instructions 3 to 8, 
M7TE i- The system nare "GRAPH* rust always be OPITAL letters. 

Getting Started (Dbk Demonstrations) 

Load the diskette tajpplied with the high resolution graphics 
racdificatictt) into disfc drive and press the reset button. 

As the diskette is self tooting this cperation will result in the 
display of a nenu offering 4 cptions. The user is requested to enter a 
choice, - simply type in the runfcer of yz*ir choice - fthe msnu choice 
acceptance relies en an INKEY routine so there is no roquirenent to 
press <ENreft>). 

Press number 1 and see what happens!. 

There it took a little while but the screen now displays a chess toard 
pattern t a full set of chess piece images. 

This is a demonstration to show the user the quality and potential 
available froa the high resolution graphics facility. The set of 
characters used to create this chess picture are those always loaded by 
default when accessing cptioo 4. 
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Setup (continued) 



Nor pro&i any key -viJ *?e another demonstration. 

The screen now deptctfl a circuit diagram of u DC powr supply. 

Once vk].iin thi3 is only a dt>i?t)fi9tMt ion but it shw£ quite clearly the 

advantvyufi *a U> dertVAi fror. tw hi*)h resolution graphics facility. 

The graphics us«ri to create this picture are available on the diskette 
8U(4>:i>xl aril ray I'- *KVe.4*«l tr xr onr ion 4 by <L»amH»] character set 

The dtflonst rat ions ?» far have indicate) The quality and the static 
possibilities of hi^h resolution graphics. 

Let us rxiw ajo what cm be done to bring life to the ayst«t. 

Press the letter <E> aid hold it down for a low .seconds. This will 
break fro* option I and return you to the aain nenu. 

Ncv select option 2 9 

Initially the screen will display .1 ft*w sentences describing *4>ot is to 
follow. Take a fjoas look ar this tecaase it shows an oscurple of the 
fully dose***linq low? OUft ncelificntUxi built into the system. 

Hold dow. the <&/a: ftAR> -o charge the display. 

Five displays of a stvtionistd Internal ranfcustion engine will appear 
on tht* screen, Tte (oar outer displays depict the individual strokes of 
a "Four Stscko FAjinc". the «ntr* display s!wws an animated version of 
the cxxrplete cycle oi operation, i.e. The revolution ot the crankshaft, 
the rise and Call of the piston and the openinq and closing of the 
inlet ind exhaust valves. 
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At this point typing i:i a ituiber from to 9 will control the speed at 
which the engine rum* 

So high resolution graphics or? not limits to the display of set 
patterns, in addition Co CC«M ing better quality graphics, they can be 
animated as required. 



These aWronst ration** will have indicated sow? of the possibilities 
using RAM taisad high resolution graphics, otoiously the range is 
United only by th>- iiayiiR/itinn of f t>' un^r. Press <K> to return to th? 
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Using the System 



Character Setup (Oplion 3) 

Creating Graphic Characters aiti Picture*. 

After reading the annual it is recooaertied that you, thi" cjvrator, use 
and expcri.T**nt with the system to familiarise yourself with th*j 
ccftiranis. In this way jou will quickly bocoic conversant with the 
creative potential of the system. 

So* lots qol down to creating ttrae new and personal high resolution 
graphic characters. 

Firat of oil sketch out a pattern or picture en a ccpy or the grid 
layout in Aftjadix "A - of this manual. The heavy lines on the qrid 
layout which split the grid into a 12 x 6 eel I |*ttt**rn, indicate the 
limits of each character block. 

Then ruirter *>ich of the 12 x 6 blocks that ^*ir picture uses starting 
at nunfcer 128. 

Using cpHon 3 in the sain Kenu - and following the instructions 
relating to that cation (see page 6), The user can create the graphic 
characters required to reproduce the picture sketched. 

When creating a character it is necessary to set each of the individual 
cells in ti» 12 x 6 block that has a sketch line drawn through it. 

Sketching the layout of the graphic characters prior to creating them 
will save a considerable «iount of adittng time when yxi get around to 
afisenblirrj the picture. 

Selecting option 3. Alices the user to set up graphic characters as 
required. On pressing <3> at tha rain renu the screen will clear and 
display :- 



Biter SUrL character (128-255) 



Enter the nunter required and fceas <ENTER>. Pressing 0/TER> only will 
default to character 128. The ftrreen will clear and display i- 



Char*:ter (CI cr lamediate (I) update 



pressing <C> will mablc the user to construct a character in the left 
hand xi up grid. When <f9fTtiR> is pressed, to accept tlw character 
formed, the true size character will appear above its nunter <xi tta 
extreme right hand top of the display. Pressing <I> has the sacne effect 
as <c> with the added advantage that, as every position in the grid is 
set it is duplicate, real size, en the right hand top of the display. 
This nuk- of character construction is slightly slower than using the 
<C> cptinii, i^on selection of either of the above options the screen 
will once anre clear and display :- 



Hw Gmracter set <N> or Re-enter prograrare <R> <Disk Only) 
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Using the System (continued) 



Pressing <N> will cloar all character positions in the graphics box 
wcory. Selecting <R> will alle** the user *o rc-cnlor the set up node 
to access or update a previously loaded or censtrjeted character set. 

Note 

Tt is rtcontended that <N> be selected tho tirst time option 3 
is used following initial power up* 



When cne of the options abov* iua been soloctoj, t>w scri 
and display :- 



will clear 



II? Iff tfi Iff l£ 1*4 IB tft. |p 1^5 
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The grid, en the left side of the screen neaairlng 6 cells by 12 cells, 
represents the Bise of a single graphic character. Kith a blank space 
bounded by tw f vortical white lines on the right hand side representing 
a central portion of the video screen are) designated the "Picture" 
area. 

Across the bottcm of the arroen are the ceraanda necessary to create 
and save graphic characters. Hhilst at the tcp right, above the picture 
area, will te displayed a range of ten character cede nutters and the 
graphic characters they represent , 

A cursor will be flashing in the top left cell c£ the setup grid. If 
the right hand graphic code nunher represents an «cisting gr^hic 
character then the shape of that character will be displayed in the 
setup grid if the <U>pdote key is 



To create a graphic character, decide en the img* *>u wish to create 
then ddvc the cursor to the cell position jou wish to set and frees the 
<SPJTC BAR>. This will white out the cell poeiticn at which the cursor 
set and the cursor will cove to the next cell en the right: cf the 
rcw or to tho first cell en the left of the next row down. 
Caitinue roving tho cursor and setting the ceils until the desired 
character is raaplote. Should an incorrect cell be set, place the 
cursor en the Incorrect cell location and press* the <#> key. This will 
reset the cell. 

Once a character is cenpieted, pressing <entkk> will set the character, 
allocate it a character cede nuafcer and clear the setup grid reedy for 
the creaticn of the next character. To ensure that each character 
matches its adjacent ase when used to create a picture, they can be 
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Using the System (continued) 



assembled in the "Picture" area en the right, *ft> do this naetfs <?>< & 
cursor will flash below the right hand graphic charact«-r Jt the tujo of 
the ncrcon. 

Pressing <B*TER> will Insert this character into the top teft tvm\ 
corner of the picture area and it my be nov*i into tfw required 
position with the <ARflCtf> keys. 

Pressing the <&PCZ BAA> will set the character In this position, 
leaving the saa» character available to be roved to amthfci: Ideation 
and eet as required. 

Pressing <tNTER> will 3et the character into position and return tto 
cursor to the graphic character selection at the tc^ of the screen so 
the sane procedure ray be followed until a ccnplete picture is 
coipiled. use of the <;> cr <-> keys enables the user to Mloct tlv; 
character required for use. 

To erase a character cr clear a block en the "Picture" area, *& tlie 
cursor in the correct location and either overwrite with a now 
character or press <B> to clear. 



Should the characters created not ratch cr should additional characters 
need to be created ^ou can return to the setup pcoceedure by Dressing 
<E>. 

fOTE :- 

If a character is displayed in the "Picture" area and a charge is 
made to the format of that character using the <U>pdate facility, the 
change will be reflected in the picture* 

When crnpiling a picture it nay prove easier to display tne graphics as 
black en white (Inverse). 

To do this - after pressing <?> press <W>. 

In this node pressing <8> will return yau to a blank picturo area. 

To <S>ave or <L>oad (Disk Only) a character set, the cursor MiSr be 
in the left hand setup grid. 

Oice the range of graphic characters is caiplete type <S> vtf the 
Screen will prcopt I- 

EWTER DISK »WC <tt <?> TO EOT 

Pressing <#> will return the user to the graphics setup. 
Typing in a naim, of up to olght letters, and pressing <tNTKR> will 
save a sot c£ 128 graphic characters to a disk file of that nam? ready 
for recall at any tiTO. 

To reload aiU <«it a "Graphic Character Set" previously saved to disk * 
type <L>, enter the nsne given to the character set when saved ord 
press <BRBt>« Tte required character set will then becont* available 
for editing. Simply select the required character using the <;"* or <-> 
keys and <U>jxlatc the cells of the character as required. 

Dent forget to save vour edited version to disk!!! 



To exit fr<xn this eption press the <E> key. A flashing display will 
appear at the bottc*n of the screen asking :- 
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Using the System (continued) 



ARE YOU SURE TOU WISH TO EOT TO START (¥/N) 

Answer as *n>rcpriato. This facility has been included to prewnt 
Accidental 1dm of the current character set. Answering "V will rclurn 
you to the win annu. 



Disk Screen Edllor (Option 4) 

Selecting option 4 At the anin crnnu will clear the arrecn ard 
display : - 

A range o£ camards, across the top of the aensr.. 

A sot of graphic characters, acr .-:-. the bottom -A the screen. Tne 
chess character ant is always loaded by default , 

A cursor will bo flashing in the tC|> left hand corner erf the screen ard 
it will be seen that this cursor is in the form of the character 
displayed at the bottom centre of the display. Kach character selected 
acts as its cwn curaor. 

Pran this position and using the ccorands displayed, the picture of 
your choice can be created en the screen. 

To do this, nova the flashing character selected to the required 
position en the screen and set it into position by pressing the <S>JCE 
BAR>. If the saco character is required in another position, ainply 
rove the curscr to the new position and press the <3>ACE BAR> ajain. 
Chanqing character is achieved using the <-> cr <;> keys. The cursor 
will also change to represent the character chosen. If the <Q£AR> key 
Is pressed after entering option 4, then the PSZU characters, direct 
frcn the keyboard, nay be incorporated in the picture display. Pressing 
<0£AR> a^ain will return control to the graphics set currently loaded, 
follow this procedure until the picture is cccplnte. 

The completed picture can be saved to disk for future recall and 
display by using the <S>aw coanand. 

As the displayed comers show, an alternate, previously saved set d 
characters can be loaded cnto thr screen so any desired picture can ta 
created. 

After typing <L>, reply to the screen request to load either a 
character set cc a picture and tht»n press <feNTER>. It is iapartant that 
if a picture Is loaded, its corresponding character set Is also loaded. 
Failure to folic** this nay give unpredictable rosults* 

Stould the name typ*5 in be incorrect, the screen will display the 
message :- 

CAN'T tOAD FllJi : QiEKK MWt I 

and after a short £*iusc return to the request for the none of the 
graphic set required. 

To exit frca the <L^oad cption press the <9> key. Beit frcm cption 4 
and return to the sum menu is achitwod \rf pressing <E>. 

A sjimary of ccflroandfi for both cpticn 3 and 4 arc listed on the 
following pagta. Try than and yen will aoon appreciate their function. 



IBVlf 111** Rf^tatW* <*ipimc* 



Instruction Summary Sheet 



Graphic Character Setup (Option 3) 

Igtt HW GfUO (Character Focmtion todel* 



<+> 
<t> 

<SPACE BAR> 
<9> 

<EKTER> 
<E> 



<I> 
<l> 
<P> 
<R> 

<S> 
<U> 

<W> 



Have cursor one cell to right 

ttsve cursor cne cell to Left 

"fcve cursor one cell de*m 

*fcve cursor <x,o cell up 

Set (vhite-out) cell 

teset cell 

Accept character (as forced in grid) 

Ibcit option 3 

Blank out character grid 

Invert existing character in grid 

Ixad graphic character set 

Have to "Picture" area 

totate character afcout centre axis in 
grid 

Save graphic character set 

Update character in grid (indicated by 
number) 

WUte out character grid 
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Instruction Summary Sheet 



Graphic Character Setup (Option 3) 

PICTURE AREA (Fonn Picture Hxte). 

CHARACTER SELECTION ;- 



<;> or u> cr v ■> 
<-> or c=> cr v> 
<*> 
<t> 

<ENTLR> 

<B> 
<W> 

PICTURE IAYCOT t- 

«> 
<4> 
<*> 

<atiFr-» 

<SV£E BAR> 
<WTEB> 



Select next higher runfr-rtd character 

Select next lowr rqxTberod character 

Select 9th character loWT 

Select 9th character higher 

Place selected character onto 
"Picture" area 

Blank cut "Picture* area 

Whito cut "Picture" area 



>bve cursor coe space to right, 

Jta/e cursor coe space to left. 

*tove cursor coe space down, 

M^ve cursor coe space up, 

>tove cursor 5 spaces to right, 

Mive cursor 5 spaces to led. 

Set character ard novo cursor to 
next apace retaining saw character. 

Set character ard return cursor 
to graphic selection. 

Erase character at cursor location 

ftjturn to left harci grid. 



It 
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Full Screen Kdilor (Option 4) 

■< 

<t> 
<t> 

<saxn ■** 

4mmi > 

*;> 

«*- 

<+> 

<*> 

<S>;£E BAR> 
<£NTER> 



I ' 
S> 



Jtore cursor ono lpK4 to rtyht, 

«t«3 cursor one apace to Icf:- 

!*w cursor ro* spam up. 

M*/e corsx one ^ict Jor . 

Jfcw cursor 5 scw;S to righl. 

Have cursor 5 spflci** u> 1*: t . 

Increment character by 1. 

Decrement character hy 1. 

Increment character b/ 15. 

Decrement character by 15. 

Set character in position and 
rove cursor to next space on right ■ 

Set character in position and 
leave curoar at sane location. 

ltggle between AKII and oraphics ffede 

Erase character at cursor location 

Exit Cption 4. 

1 - bJ*i of-«pi!lc character 3£t 

2 - UAi M ved -Picture* 

Savo picture to dis*. 

Allows exit frcm <L>ond cenmnc 
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Example Programmes 




The following proqcocivs demonstrates taw easy it is to access. 




display and update pact character sets. The utdate technique can be 




utilised within a basic programme to create your own characters. 




NHS 1- Tape U9ftrs rawt ensure ttot their original "GMPfT ^rcgranne is 




first loada). 




10 HO* ** aXTTIPC TO ALTS* Wf OWUCDB -IKE (128 TO 255) 




20 a^;a£AR500:fEFINTA-Z 




30 0UT155,1:KM ** SET IN HIGH RESOLUTION *CDE 




40 rosX*128TO255:PRJNrX;CHRS(X);ihOCr:ffiM ** HfiW CHAS/CrtKS 




50 L"0:O0:A-0:FO4 ** ASSKF FUGS 




60 WWBJTER QiAWCTfiH MJMBrfS U28-25&) ";Bi(K6UBl30 




70 B*B-128:C**16:FEH ** CALOJIATK AlJ3PfcSS TO "JPDOTF. 




80 IWWQtfER 3TCIMAL HJWEB TO OWGK (0-63) ";A:G3SURl3G 




90 INPWQfl'ER Uffi NJMER <0-U) CR OfrSR> ";L:G0SUBl30 




100 CUT140,i:l£M ** ST IN HIGH RESDLJTiCW WITTS fCOE 




110 FCKFT>L,A 




120 OrP130,l:O3ro50 




130 PRINTg896,CHR$(31>;:REnjaN 




140 END 




5 EBN " ECCfn* TO DRAW A DIMQKAL LINE CK S3SEK 




10 GLSsCtEAR500:C£FiNrA-Z:tf"l 




20 CUT140,1 




30 K^-Ol05:reKQC,N:P3ao;t22,S;tt*f*N 




40 racr 




50 CUT130,1 




€0 KWX-OTO1023STEP66 




70 rHIMTWC*CHRS(l28)+af<S(i?9>j 




60 «3CT 




90 OTIO90 




5 REM ** HXTTIfC TO DRAW SQQRRK C* RCTMOU 




10 CLS(<X£AR5O0:C£FINrA-Z 




20 OOTl55,l:CUri40,l 




30 PDRX-OTOn:PC«X f l!K«E<+I$,32:^E)C^ 




40 ?CKE32,63:K*K58,63 




50 0W1 30,1 




60 pRrwr*o,j:iwwa?THR N0HBBB CF CHAIVCTESS *CpC6S ";AS 




70 n^AL<AS)<l<»/AL(AS)>62raEKWKr«0 f CKi«(3l) 




80 C»TC60ELSEAWAL<AS> 




90 PRIKr?l28,;:lNEVr , a*THK NuTO&ft CF CUAttCrERS CCMN ";DS 




100 IFVAL(^)<10RVAL(DS)>13™ENPRISr?l28 # CKRS(31> 




110 OTK#0ELSE>-VAUD$)-1 


4 


uo as 




130 PRIMTTAB<l>OTRI>CS(A # l3nj 




140 trjRY-OlOD:FKNr?(Y4-l)*64,aiRS(128)? 




150 PRIOT(M(Y+l)«64>+Aa,CHR$<129)f 




160 *ECT 




170 PRINTe<(D+2)*64)n,OTIUJCS(A,130); 




180 IF IKKKYS«"THBN180ELSS10 
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Tlfe-M III** H< . . fen <»* *i.» p6*c* 



System Assemhh 



Keyboard Wilh Interface 




Plug Wide Ribbon 
Cable into 40 Way 

Bus l \ i nisi* >ii , 



20 Way Ribbon 
Cable From Ke\ board 



Keyboard Without Interface 



20 Way Ribbon / 
Cable from Keyboard 

Plug Wide Ribbon 
Cable into 40 Way 
Bus Kxtension 




Kefer lu General Ih-xriplion on Page 2 



Graphic Character Setup Sheel ( Appendix A ) 



t — r 



~* — r — ■ — i — r 
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t — — r— r 
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-+ * 



iir 






■ i \ 



j ; ' ■ | ! , ~TT 




i_ 



FFP 



* ' t 



----- - 



i i r 



— ff-;-' J F r:rt 
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T*t 
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I fcvH Hitfh R^t-rbn GnpMo 



High Resolution Graphics 

SETXY AND PRINTER 
DRIVER PROGRAMME 




Setxy 



Sclxy 

Setxy is a rachine language programs which can be loaded optionally 
' rvjn disfc or cassette tape. 

individual pixels can be set or reset, it is also possible to detect 
the status of individual pixels, this is similar to the standard 
point routine bat requires a different syntax. Although »*txy allore 
plotting there are still enly 128 graphics characters niiich can be 
allocated. T>3 optimise en character allocation setxy mintains 
internal control and reuses raiundent characters. Even &> it is 
necessary to ccrcaider the size, ccmplexity and repetition of 
characters. 

If a <tesign or picture utilises all 128 characters an cut of narory 
error will occur. If this error occurs whilst setxy is drawing co the 
screen then rationalise en your design and re-run ycur program. A 
divide by aoro error will occur if the co-ordinates given for a 
rectangle are on the sane horizontal or vertical plane. The only 
other error rossage generated by sctxy is a function call error. This 
will occur if a point is accessed outside of the screen range for the 
version of «txy being executed (see Appendix B). 

Facilities have teen included in setxy to :- 

a) allow the screen to be cleared aixi all characters 
to be reallocated. 

b) allow a point to be sot or reset en the screen. 
c> allow vectors to be plotted or reset. 

d) allow status of a point to be returned. 

*») allow rectangles to be drawn or reset. 

f) allow filled rectangles to te draxn or reset. 



U3T£ t Disk users cks not need to load Snt3/<M> to uso setxy. Tape 
j-ts trust not load the GRAPH tape when using setxy. *ft> print 
existing characters created using setup load the a^prcpriate OlAPH 
Vipi arri then load the PRINT side of the cassette supplied. 
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Setxy 



Loading Selxy Tape 

1* Power up carpi tor as nonral. 

2. Answer **srory size by pressing <c*ira>. 

}• Put SETXY side of tape into recorder and rewind. 

4. At Ready pratipt type SYSTH4 and press 0*TfcR>. 

5. At *? prctipt type SETXY, pit recorder into play, 
press <VNTER> 

6. On ccnpletioo of a successful load the screen will 
clear, Setxy initialised will appear, 

7. At the Ready precept load or type in ^xir progrannrs. 



Loading Print Tape 

tt/TE : PRINT is appended to SETXY therefore it need 

only be loaded separately if characters created 
by SfrTIW are to be printed. 

Follow losing instructions 1 and 2 as above 

3. Put "GRAPH" side of tape into recorder and rewind. 

4. At Ready praipt type SYSTEM and press <ENrat>. 

5. At *? prenpt type CRAPH, put recorder into play, 
press <Effira> 

6. On cccrpletion of a successful load the Ready prenpt 
will appear. 

7. Put "PKIVT* side of tape into recorder and rewind. 

8. At Ready praipt type SYSTEM and press <EHRR>. 

9. At *? praipt type PRINT, put recorder into play, 
press <EWiB<> 

10. On ccnpletion of a successful load the Ready prarpt 
will appear. 

11. Load or type in your prcgranne. 

The aborc "QWfP tape should be a user created character set. 



Loading Setxy (Disk) and Printer Driver 

1. Load SKDCY disk into drive and press reset. 
The auto conrand will load SIR3/CMD on pc*er-up. 

2. At the rOS READY praipt type LOAD SEIXY/O© (only if 
STCFXY is to be used) 

PRINTAW will work with cither SEIXY or characters 

created using SETUP 
J, At the tOS Rfi^DY praipt type IHAD FRWTAM> press <EOTtS> 
4. Follow the revised loading instruction sheet. 

tore | 1. 46k disk systais cnly. 

2. cption 5 at rain msnu initialises SETCY. 

3. Upgrades prior to 17/03/82 my not have 
have the enclosed errata sheet. 
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Setxy 



a*WAND 


DESCRIPTION 




CMC 


Clears cut all 128 characters, sets all 
pointers to zero and clears the acruen. 




OD(X,Y) 


Draws a dot at position X,Y 
Exanples : MD(100,100) 
Q©(A,B) 




CMD*(X,Y) 


Resets the <tot at position X,Y 
Exanples :- CMD*(100,100) 
CM>*(A,B) 




4P(X,Y) 


Returns the status of the <tot at 
position X,Y. Dot on returns -1 
Dot off returns 0, 
Examples :- ?*P|100,100) 
0*P(A,B) 




LStfT(X,Y,Xl,Yl> 


Draws a vector (line) between X,Y and XI, Yl 
Exanples :- i£CT(0,0, 100, 100) 
LSCT(A,B,C,D) 




LSCT*(X,Y,X1,Y1) 


Resets the vector (line) between 
X,Y aixl XI, Yl 

Exanples :- ISETM0, 0,100, 100) 
I£ET*tA,B,C,D) 




RSCT(X,Y,X1,Y1> 


Draws a rectangle using points X,Y and 
XI, Yl as opposing corners, 
Exzvples :- RSbT(0,0,100,10G) 
RSCT(A,B,C,D) 




RSCT*(X,Y,X1,Y1) 


Reacts a rectangle using points X,Y and 
XI, Yl as closing corners. 
Examples :- RSCT*(0,0,L00,10OI 
RSCT*(A,B,C,D) 




RSKIF(X,Y,Xl,Yl) 


Draws a filled in rectangle using points 
X,Y and Xl,Yl as opposing corners. 
Exanples :- RSE^V(0, 0,100, 100} 
RSFIV(A,B,C,D) 




RSEIV*(X,Y,X1,Y1) 


Resets a filled in rectangle using paints 
X,Y and XI, Yl as opposing corners. 
Exanples :- RSElF*(0,0,100,100t 
RSEre*(A,B,C,D) 





Note :- All the afcovc coordinates nust fee within the range, listed 
in Appendix & * * or S°™ f»chine. 
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Selxy 



Appendix B 

33UTOJ LIMITS 

X Coordinate 
V Coordinate 

'JS&VL AIXftESSES 

[ASCRIPTION (SCTXYJ 



todcl I - to 183 
fctodei I - to 191 



HEX ADO 


DEC ADD 


DISK/TAPE 


P920 


63776 


DISK 


P97D 


63669 


DISK 


P955 


63829 


DISK 


5306 


21254 


TAPE 


PA61 


60000 


DISK 


EA61 


60000 


DISK 


4C01 


19457 


TAPS 


mz 


65410 


DISK 


5675 


22133 


TAPE 



INITIALISATION A1XRSSS 
SYSrtM BZBtt ACCRESS 
UXASE VSKY ACCRESS 
l/)case amtv AECttESS 
PHorarr *>dr¥ 
otaot of routine 
srA*r of RarriNE 
&v of Bxrnrc 

SS) OF KVTI* 



USH EOKfcS TOR PH WIWT fCCTINE TOKB16526,105:PDKEl6527,78 



hKrtJK oxor riots 

Error Code. 
Error Message. 
Probable Cause, 
itaiedy. 



Error Code. 
Error Message. 
Probablo Cause, 
Renvxly. 



Error code. 
Error Massage. 
Prccable Cause, 
Rerredy, 



Out of Harory, 

All 128 Characters used. 

Type 0*x: <Q/T3*> rationalise cxi ^raur 

design and re-run yo^ir programme. 



Illegal Function Call. 

(X,Y) Coordinates out of range. 

Check Afpcoiix B (screen limits) alter 

coordinates and re-run yoor progranro. 



11 

Divide by Zero, 

X-0C1 or Y«Y1 in any RSCT parameters. 

Alter RSCT parameters arxi re-run y&jr 

prograrme. 
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Selxy 



Setty Example Programmes 



5 "WXTTINE TO PRINT RATCCM COTS IN A BDX 
10 ODJ:Ce^INtA-2:RWCC« 
20 X0=100;YO*47:X>284:Yl»93 
30 RSCT{X0,Y0,Xl,Yl):RSETlXO+l,YOfl,Xl-l,Yl-l) 
40 X*SD(Xl-6-X0):Y*M)lYl-€-Y0);X^C+X0+2:Y«Y+Y0+2 
50 IF|iP(X,Y}— l!HaO1D*IX,Y):0^I040 
60 OD(X,Y}:G7IO40 



5 'KX7TINE TO CHAW NE3S11I) RttTTANjl^S 
10 OCC:rS'INrA-Z 
20 X-0:Y=0:XL-383:Yl=191:l-« 

30 KSEr(X,Y,Xl,Yl) 

40 X=X+I:Y"Y+12:X1-X1-I:Y1"Y1-12 

50 IFYlXmttMO 

$0 IFIwm^^TWfcNGOELSeiO 



5 'rtCXTTINE TO OttW AN EX1PS8 WITH VECttXS 
10 i»DC:DCTINnc,¥ 
20 X-175:Y-9S:R-35:02:A-177:B-129 
JO rOR'IM).llOWN(l)*8S , m'Ara(l)/4 
40 Xl-X*O*K*SIN(T):Yl"tf«*C0S(T) 
50 LSKr(A,B,Xl,Yl):t£Pr(X,Y,Xj,YlJ 
60 NEXT 
W tFINKCT^* H m»J70K££l»;lO 
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Printer 



Primer Driver 

The high-resolution graphics printer driver routine allcw A92II 
and high resolution graphics characters to be printed on either a 
line printer 7 or line printer B. Tte routine &*$& the current 
scrocn irage to the line printer, tote lew resolution graphics 
cannot be printed. 

To print the screen content use the following routine :- 



10 Dtn»<=*HiA61:RQ4 DISK BASED SYST&iS 

20 pOKE16526,105:»KE16527 # 78:ft£M TOPE BASH) SiSTMS 

30 XMJSR(A) 

40 R&* *here 'A f is the argument passed to the print routine 



IROMHV wirmw toxical s^ale 



71 IP7 One dot per pixel. 

72 U>7 T«o dots per pixel, 
61 U*8 One dot per pi«l. 
82 IP8 Two <tots per pixel. 



H7TK. Due to the limitation of linefeed control when printing 
ASO f characters acre printouts ray give a slightly .>.-:■ 
appearance. Unfortunately this is unavoidable if ASCII characters 
(characters 32-124) are to be used with this high-resolution print 
routine. This is rot » apparent it 'A'"72 or if c A f **2. 

Holding the <ER£AK> key d>m Airing printout will terminate the 
print and return control to the camand atxie of BASIC, 



Dra» overruns 



If the printer is not ready when the print routine is called 
control will irmediately fce returned to BASIC. 

If an argument other than the four listed above is passed to the 
print routine, control will umcdiately be returned to BASIC with 
the error rofisage M.O. error or Hissing Operand. 
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\A\6(6(\(tA 

COMPUTING SERVICES (BRISTOL) LTD 









Registered Office 1 57 Queen Charlotte Street 
Bristol BS1 4HQ Avon Phone (0272) 279560 

Company Reg 1565909VATRegNo3031641 12 

Dnctont NSV<bo*ofd.ei5mHh 1 CmJtffTew.GWiftam» 



Nothing contained In this Manual or in any other document amount!) 
to a Warranty that the Programmes or material are suitable for any 

particular purpose. 

The Programmes have been thoroughly tested and considerable effort 
has been devoted to ensuring that they are free from error ; nevertheless 
Micro ware Computing Services Limited or Tandy Corporation (Branch 
U.K.) will In no circumstances be liable for any loss or damage, however 
arising, whether direct or indirect, which may be sustained because of 
inaccuracy or error In the programmes or for any other reason. 

The copyright of both the Programmes and this Manual is strictly 
reserved. 

NOTE: The operating system on the supplied diskette has been altered 
specifically for the enhanced graphics and should not be used for other 

applications. 



